home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / hostv11g.arc / HOST-III.DOC < prev    next >
Encoding:
Text File  |  1984-01-20  |  31.7 KB  |  1,454 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                HOST-III
  24.  
  25.                               Version 1.1
  26.  
  27.  
  28.        Unattended Telecommunications for the IBM Personal Computer
  29.                   Requires a Hayes Smartmodem and 128K
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                    Copyright 1984 William HT Bailey
  59.                          All Rights Reserved
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.       COMMERCIAL                  COMMERCIAL                  COMMERCIAL
  69.  
  70.  
  71.  
  72.  
  73.                     --- REQUEST FOR CONTRIBUTION ---
  74.  
  75. If  you  are  using  this  program  and  find  it  to  be  of value then a $35
  76. contribution is suggested.
  77.                            William HT Bailey
  78.                             P.O. Box 29723
  79.                        Elkins Park, PA 19117-0923
  80.                          CompuServe: 74145,1046
  81.  
  82.  
  83.                      --- USER SUPPORTED CONCEPT ---
  84.  
  85. This  HOST-III / HOSTCALL software package is being distributed under the USER
  86. SUPPORTED  concept.  That is you are granted permission to copy and share this
  87. program  as  long  as  no  price is charged for the software or documentation.
  88. Contributions,  although  completely voluntary, will compensate the Author for
  89. his  effort  and will ensure further development. Anyone may request a copy of
  90. this package by either
  91.     1. Sending the Author a blank formatted double-sided diskette (or 2 single
  92.        sided diskettes) along with a self-addressed postage-paid mailer
  93. or
  94.     2. Sending the Author $35 in which case the  diskette, mailer  and postage
  95.        will be supplied.
  96.  
  97.  
  98.                              --- DISCLAIMER ---
  99.  
  100. In  no  event  will the Author be liable to you for any damages, including any
  101. lost  profits,  lost  savings  or  other  incidental  or consequential damages
  102. arising  out  of  the  use  of or inability to use these programs, even if the
  103. Author  has  been advised of the possibility of such damages, or for any claim
  104. by any other party.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.       COMMERCIAL                  COMMERCIAL                  COMMERCIAL
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                                HOST-III
  143.  
  144.                               Version 1.1
  145.  
  146.  
  147.        Unattended Telecommunications for the IBM Personal Computer
  148.                   Requires a Hayes Smartmodem and 128K
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.                                CONTENTS
  159.  
  160.                                                                          Page
  161.  
  162.    I. General Description ...............................................  1
  163.   II. HOST-III Setup ....................................................  6
  164.  III. HOST-III Signon ...................................................  9
  165.   IV. User Commands ..................................................... 10
  166.    V. System Operator Commands .......................................... 13
  167.   VI. File Transmission ................................................. 15
  168.  VII. File Reception .................................................... 17
  169. VIII. HOST-III Signoff and Reset ........................................ 19
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.                                    HOST-III
  201.  
  202.  
  203. I. General Description
  204.  
  205. This section has two objectives. They are:
  206.     1. To describe the uses of this program.
  207.     2. To  provide  enough information so that you can start using the program
  208.        immediately.
  209. The  second  objective  is  possible, because the use of this program is quite
  210. straight  forward.  You  will  find  the  details which will enable you to use
  211. HOST-III to its fullest capability in the remaining sections.
  212.  
  213. If you and a friend have ever transferred files over the telephone lines using
  214. manual communication packages, then you know that it involves a lot of message
  215. typing  to  coordinate who is going to send what when and making sure that the
  216. receiver  is ready. HOST-III takes care of that coordination at your end. Your
  217. friend at the other end transfers the files at his own pace while you watch or
  218. attend  to  some  other  business. You could also use this program to transfer
  219. files to and from your computer while you are someplace else. These are just a
  220. couple  of  examples  of  how  HOST-III can be used. In general it can be used
  221. whenever  one  end of a communications link must be automated. However, if the
  222. computer  at  the  other  end  is  running  HOSTCALL,  then  both  ends of the
  223. communications link will be automated.
  224.  
  225. In  normal  operation, HOST-III assumes that the file it is transferring is an
  226. ASCII  file.  However  ANY  type of file can be transferred if the user at the
  227. other  end  invokes  the  XMODEM protocol of file transmission (and the user's
  228. program supports this protocol). This protocol is invoked by appending a +X to
  229. a filename specification. The XMODEM protocol is simply a sophisticated method
  230. of transferring files.
  231.  
  232. HOST-III  asks   for  a  password  before  it  allows files to be transferred.
  233. Initially the password is WORD.
  234.  
  235. The program recognizes 9 commands from the user at the other end. They are:
  236.     A - List the files on drive A.
  237.     B - List the files on drive B.
  238.     C - List the files on drive C.
  239.     D - List the files on drive D.
  240.     G - Signoff (GOODBYE).
  241.     M - Send message.
  242.     R - Receive a file from the remote location.
  243.     T - Transmit a file to the remote location.
  244.     ? - Summarize the commands.
  245.  
  246. The  program  recognizes  4 commands from the system operator at its end. They
  247. are:
  248.     CTRL Prtsc - Printout on / Printout off (of intercomputer correspondence).
  249.     ALT D      - Display files / View a file. (Inactive during a comm. link).
  250.     ALT M      - Send message to remote location.
  251.     ALT X      - Exit program.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                       -1-
  263.  
  264.  
  265.  
  266.                                    HOST-III
  267.  
  268.  
  269. Some other important notes concerning this program are:
  270.     1. HOST-III requires the use of a Hayes Smartmodem and 128K memory.
  271.     2. An  active communication  link is automatically closed, if 5 minutes of
  272.        inactivity passes.
  273.     3. If  a  file  that  is  that is being  received as an ASCII file already
  274.        exists, then the received file is attached to the end of the old file.
  275.     4. If  a  file  that  is being received  under the XMODEM protocol already
  276.        exists, then the old file is first deleted.
  277.  
  278. After the simple setup procedure (described in detail in section II), HOST-III
  279. is  ready to accept a telephone call. The 2 figures at the end of this section
  280. contain examples of HOST-III sessions. Note that the numbers on the right side
  281. of  these  figures  are not produced by the program. They are in these figures
  282. for the sake of this discussion.
  283.  
  284. Figure  1 illustrates a session in which the user at the remote location sends
  285. the  ASCII  file  PROG1.BAS  to HOST-III and requests the ASCII file PROG2.BAS
  286. from HOST-III. The following is a line by line discussion of figure 1.
  287.     Line  1. HOST-III asks  for the password and the user responds with WORD.
  288.     Line  2. This is the program's message indicating a successful signon.
  289.     Line  3. At the program's prompt (>), the user issues a ? command.
  290.     Ln 5-14. HOST-III lists the summary of commands.
  291.     Line 16. The user issues an R command.
  292.     Line 17. HOST-III  requests  the  name  of  the file  the user is about to
  293.              send.  The  drive  on  which the user wants the file to be stored
  294.              may  be  part  of  the  specification.  The  user  responds  with
  295.              B:PROG1.BAS.
  296.     Line 19. After  the  program  opens the file it is about to receive, it is
  297.              ready for the user to send it.
  298.  
  299.              The  file transfer occurs between lines 17 and 18. HOST-III lists
  300.              the file on the screen as the file is being received.
  301.  
  302.     Line 20. At  the end of the file, HOST-III pauses for about 15 seconds and
  303.              then  asks  the  user  to  confirm that  the end of file has been
  304.              reached. The user responds with Y.
  305.     Line 21. The  program closes the file it has just received and issues this
  306.              message.
  307.     Line 22. The user issues a T command.
  308.     Line 23. HOST-III requests the name of the file the user wants it to send.
  309.              The  drive  on  which  the  file  resides  may  be  part  of  the
  310.              specification. The user responds with B:PROG2.BAS.
  311.     Line 25. The  program  informs  the  user  that he has about 15 seconds to
  312.              prepare his end to receive the file.
  313.     Line 26. The  program  informs the user that he may abort the transmission
  314.              by typing an X.
  315.  
  316.              The  file transfer occurs between lines 24 and 25. HOST-III lists
  317.              the file on its screen as the file is being sent.
  318.  
  319.     Line 27. This  is  the end of file message. It is in the format of a BASIC
  320.              remark statement, so that a transmitted BASIC program may be used
  321.              without  having  to first edit it. (This message is not sent when
  322.              HOST-III is operating with HOSTCALL).
  323.     Line 28. Notice that HOST-III does not issue a prompt after transmitting a
  324.              file.  However  it  still  ready  for  the next command. The user
  325.              issues the signoff command.
  326.     Line 29. The program responds with the signoff message.
  327.  
  328.                                       -2-
  329.  
  330.  
  331.  
  332.                                    HOST-III
  333.  
  334.  
  335.  
  336. Figure  2  illustrates  a  session  in  which  the user at the remote location
  337. requests  that  the file PROG.COM be sent from HOST-III under XMODEM protocol.
  338. The following is a line by line discussion of figure 2.
  339.     Lns 1,2. Signon.
  340.     Line  3. The user issues a T command.
  341.     Line  4. HOST-III  requests  the  name  of the file. The user responds and
  342.              appends to the end of the filename specification a +X, indicating
  343.              that the program is to be sent under the XMODEM protocol.
  344.  
  345.              The file transfer occurs between lines 4 and 5. The program lists
  346.              numerous  transmission  status  messages on the screen throughout
  347.              the transfer.
  348.  
  349.     Lns 5,6. Signoff.
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                       -3-
  395.  
  396.  
  397.  
  398.                                    HOST-III
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405. PASSWORD? WORD                                                           --  1
  406. *** ENTER ? FOR SUMMARY OF COMMANDS ***                                  --  2
  407. >?                                                                       --  3
  408.                                                                          --  4
  409.       --- SUMMARY OF COMMANDS ---                                        --  5
  410. A - LIST THE FILES ON DRIVE A                                            --  6
  411. B - LIST THE FILES ON DRIVE B                                            --  7
  412. C - LIST THE FILES ON DRIVE C                                            --  8
  413. D - LIST THE FILES ON DRIVE D                                            --  9
  414. G - SIGNOFF (GOODBYE)                                                    -- 10
  415. M - SEND MESSAGE                                                         -- 11
  416. R - RECEIVE A FILE FROM YOUR LOCATION                                    -- 12
  417. T - TRANSMIT A FILE TO YOUR LOCATION                                     -- 13
  418. ? - PRINT THE SUMMARY OF COMMANDS                                        -- 14
  419.                                                                          -- 15
  420. >R                                                                       -- 16
  421. NAME OF FILE: B:PROG1.BAS                                                -- 17
  422.                                                                          -- 18
  423. *** READY TO RECEIVE FILE ***                                            -- 19
  424.                     .
  425.                     .
  426.                     .
  427. RECEPTION SUSPENDED. END OF FILE? (Y/N) Y                                -- 20
  428. *** RECEPTION TERMINATED ***                                             -- 21
  429. >T                                                                       -- 22
  430. NAME OF FILE: B:PROG2.BAS                                                -- 23
  431.                                                                          -- 24
  432. *** TRANSMISSION BEGINNING IN 15 SECONDS ***                             -- 25
  433.     TYPE X TO ABORT TRANSMISSION                                         -- 26
  434.                     .
  435.                     .
  436.                     .
  437. 65529 ' *** TRANSMISSION COMPLETE ***                                    -- 27
  438. G                                                                        -- 28
  439. *** GOODBYE ***                                                          -- 29
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448. FIGURE 1. Sample HOST-III session.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.                                       -4-
  461.  
  462.  
  463.  
  464.                                    HOST-III
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471. PASSWORD? WORD                                                           --  1
  472. *** ENTER ? FOR SUMMARY OF COMMANDS ***                                  --  2
  473. >T                                                                       --  3
  474. NAME OF FILE: A:PROG.COM+X                                               --  4
  475.                     .
  476.                     .
  477.                     .
  478. G                                                                        --  5
  479. *** GOODBYE ***                                                          --  6
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488. FIGURE 2. Sample HOST-III session using XMODEM.
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.                                       -5-
  527.  
  528.  
  529.  
  530.                                    HOST-III
  531.  
  532.  
  533. II. HOST-III Setup
  534.  
  535. This  section  describes  the  setup  procedure  that you must complete before
  536. HOST-III  will  be  ready  to  receive  a  telephone call. The setup procedure
  537. involves  getting  the  program  started  and  providing  information  on  the
  538. following items:
  539.     Password
  540.     Communication parameters
  541.     Screen width
  542. Your  setup  will  be  saved  and presented to you the next time you start the
  543. program. Therefore the full setup must be completed only on the first time you
  544. run the program, and when you want to change the setup.
  545.  
  546.  
  547.  
  548.  
  549. Connect and turn on your Hayes Smartmodem. Insure that the lights above the TR
  550. and MR are lit.
  551.  
  552.  
  553.  
  554. The following are the 2 steps required to get HOST-III loaded and running:
  555.  
  556.     1 . Insert  a  disk containing the Disk Operating System into disk drive A
  557.         (the drive on the left) and turn on the computer. Answer any questions
  558.         the  computer may ask you (such as DATE and TIME) until you get to the
  559.         point where the computer prompts you with
  560.  
  561.         A>
  562.  
  563.     2a. If the disk currently in drive A contains HOST-III then type
  564.  
  565.         HOST-III
  566.  
  567.         Press carriage return.
  568.  
  569.     2b. If  the  disk  does  not contain HOST-III  then  remove  the  disk and
  570.         insert your disk containing HOST-III into drive A. Type
  571.  
  572.         HOST-III
  573.  
  574.         Press carriage return.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                                       -6-
  593.  
  594.  
  595.  
  596.                                    HOST-III
  597.  
  598.  
  599. HOST-III  begins  by  printing a heading, a copyright notice and the following
  600. questions.
  601.  
  602.  
  603.     Current password is WORD
  604.     Is this OK? (Y,N):
  605.  
  606. A  user  of HOST-III must provide the current password before he/she is signed
  607. on.  If  you  do not want to change the current password, then enter Y (or y).
  608. If you  do  want  to change the current password, then enter N (or n).
  609.  
  610.  
  611.     Enter new password:
  612.  
  613. If  you  responded  to the previous question with N, then the program will ask
  614. for the new password. This new password of 8 characters or less will remain in
  615. effect  for  this  and  all  future  uses  of HOST-III, until it is once again
  616. changed. UPPER AND LOWER CASE LETTERS ARE NOT INTERCHANGABLE. For instance, if
  617. you change the password to abcdef, then program will not sign on a user if he/
  618. she  enters  ABCDEF  as the password. If you are using HOST-III with HOSTCALL,
  619. then  changing  the  password will have no effect on operations since HOSTCALL
  620. bypasses the password requirement.
  621.  
  622.  
  623.     Do you want to lockout HOSTCALL? (Y,N):
  624.  
  625. Since HOSTCALL bypasses the password requirement, a person calling your system
  626. using HOSTCALL could access your files despite a changed password. This option
  627. permits  you  to  prevent access of your system by HOSTCALL. Enter Y (or y) if
  628. you want to lockout HOSTCALL. ENTER N (OR n) IF YOU DESIRE COMMUNICATIONS WITH
  629. HOSTCALL.
  630.  
  631.  
  632.     Current communication parameters are:
  633.          SPEED     300
  634.          PARITY    E
  635.          DATA BITS 7
  636.          STOP BITS 1
  637.     Are they OK? (Y,N):
  638.  
  639. If you do not want to change the communication parameters, the enter Y (or y),
  640. and  the  program will skip the next 4 questions. If you do want to change the
  641. communication  parameters,  then enter N (or n). If you do not understand this
  642. question,  then  enter  Y (or y) since the default parameters will suffice for
  643. most cases.
  644.  
  645.  
  646.     SPEED (75,110,150,300,600,1200):
  647.  
  648. Enter   transmission   speed.  (This  question  is  skipped,  if  the  current
  649. communication parameters are OK).
  650.  
  651.  
  652.     PARITY (S,O,M,E,N):
  653.  
  654. Enter  parity  type.  (This  question is skipped, if the current communication
  655. parameters are OK).
  656.  
  657.  
  658.                                       -7-
  659.  
  660.  
  661.  
  662.                                    HOST-III
  663.  
  664.  
  665.  
  666.     DATA BITS (4,5,6,7,8):
  667.  
  668. Enter  the  number  of  data  bits.  (This question is skipped, if the current
  669. communication parameters are OK).
  670.  
  671.  
  672.     STOP BITS (1,2):
  673.  
  674. Enter  the  number  of  stop  bits.  (This question is skipped, if the current
  675. communication parameters are OK).
  676.  
  677.  
  678.     Choose screen width (40,80):
  679.  
  680. Choose  the  number  of  characters you want displayed across your screen. You
  681. should choose 80 unless your display does not have the resolution to handle an
  682. 80 column screen.
  683.  
  684.  
  685. At this point the program will clear the screen, display the message
  686.  
  687.     ********* HOST COMPUTER III program active *********
  688.  
  689. and turn on the light above the AA on the Smartmodem. HOST-III is now ready to
  690. receive a telephone call.
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                                       -8-
  725.  
  726.  
  727.  
  728.                                    HOST-III
  729.  
  730.  
  731. III. HOST-III Signon
  732.  
  733. This  section describes the signon procedure that a user calling into HOST-III
  734. must complete before he/she will be allowed to transfer files.
  735.  
  736.  
  737. When  a  user  dials HOST-III, the program answers the telephone and asks  the
  738. user the question
  739.  
  740.     PASSWORD?
  741.  
  742. If an incorrect password is given, then the program says
  743.  
  744.     TRY AGAIN
  745.  
  746. If  the  correct  password is not given in 3 tries, then the program tells the
  747. user
  748.  
  749.     *** GOODBYE ***
  750.  
  751. and signs off.
  752.  
  753.  
  754. If the current password is received within 3 tries, then the program says
  755.  
  756.     *** ENTER ? FOR SUMMARY OF COMMANDS ***
  757.     >
  758.  
  759. and signon is complete.
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.                                       -9-
  791.  
  792.  
  793.  
  794.                                    HOST-III
  795.  
  796.  
  797. IV. User Commands
  798.  
  799. This  section  describes  the  commands that a user can issue to HOST-III once
  800. he/she is signed on.
  801.  
  802.  
  803. HOST-III recognizes 9 single character commands from the user. THey are:
  804.  
  805.     A - List the files on drive A
  806.     B - List the files on drive B
  807.     C - List the files on drive C
  808.     D - List the files on drive D
  809.     G - Signoff (GOODBYE)
  810.     M - Send Message
  811.     R - Receive a file from the remote location
  812.     T - Transmit a file to the remote location
  813.     ? - Summarize the commands
  814.  
  815. The prompt
  816.  
  817.     >
  818.  
  819. indicates  that the program is ready to accept a command. All commands must be
  820. terminated  with  a  carriage  return.  If HOST-III is expecting a command but
  821. receives something longer than 1 character, then it issues the message
  822.  
  823.     SINGLE CHARACTER COMMANDS PLEASE
  824.  
  825.  
  826.  
  827.  
  828. A description of how HOST-III responds to each command follows.
  829.  
  830.  
  831.                                       A
  832.  
  833. The program responds with
  834.  
  835.     FILES A
  836.  
  837. and sends the file directory of the disk in drive A. Possible error conditions
  838. such  as an open drive door or an empty drive will be detected and will result
  839. in  the  program  issuing  a message  followed by its prompt. The program will
  840. then wait for the next command.
  841.  
  842.  
  843.                                       B
  844.  
  845. The program responds with
  846.  
  847.     FILES B
  848.  
  849. and sends the file directory of the disk in drive B. Possible error conditions
  850. such  as an open drive door or an empty drive will be detected and will result
  851. in  the  program  issuing  a message followed  by its prompt. The program will
  852. then wait for the next command.
  853.  
  854.  
  855.  
  856.                                      -10-
  857.  
  858.  
  859.  
  860.                                    HOST-III
  861.  
  862.  
  863.                                       C
  864.  
  865. The program responds with
  866.  
  867.     FILES C
  868.  
  869. and sends the file directory of the disk in drive C. Possible error conditions
  870. such  as an open drive door or an empty drive will be detected and will result
  871. in  the  program  issuing  a message  followed by its prompt. The program will
  872. then wait for the next command.
  873.  
  874.  
  875.                                       D
  876.  
  877. The program responds with
  878.  
  879.     FILES D
  880.  
  881. and sends the file directory of the disk in drive D. Possible error conditions
  882. such  as an open drive door or an empty drive will be detected and will result
  883. in  the  program  issuing  a message followed  by its prompt. The program will
  884. then wait for the next command.
  885.  
  886.  
  887.                                       G
  888.  
  889. This  is the signoff command. It must be issued before the user hangs up. Upon
  890. receiving the signoff command, HOST-III issues a
  891.  
  892.     *** GOODBYE ***
  893.  
  894. and  resets  itself so that it may receive the next call. The user may hang up
  895. after he/she receives the
  896.  
  897.     *** GOODBYE ***
  898.  
  899.  
  900.                                       M
  901.  
  902. This command allows the user to send a one line message to the system operator
  903. (the  operator  at  the computer which is running HOST-III). User messages are
  904. received  and  printed  without  interpretation by the program. Upon receiving
  905. this command, the program transmits
  906.  
  907.     ENTER 1 LINE MESSAGE
  908.  
  909. At the same time HOST-III beeps its buzzer and prints on its screen
  910.  
  911.     *** USER MESSAGE ***
  912.  
  913. At  this  point  the  user  may  enter  his/her message followed by a carriage
  914. return.
  915.  
  916.  
  917.                                       R
  918.  
  919. This command is described in section VII.
  920.  
  921.  
  922.                                      -11-
  923.  
  924.  
  925.  
  926.                                    HOST-III
  927.  
  928.  
  929.  
  930.                                       T
  931.  
  932. This command is described in section VI.
  933.  
  934.  
  935.  
  936.                                       ?
  937.  
  938. This  command  results  in  the  printout  of the user's command options. Upon
  939. receiving this command the program transmits
  940.  
  941.          --- SUMMARY OF COMMANDS ---
  942.     A - LIST THE FILES ON DRIVE A
  943.     B - LIST THE FILES ON DRIVE B
  944.     C - LIST THE FILES ON DRIVE C
  945.     D - LIST THE FILES ON DRIVE D
  946.     G - SIGNOFF (GOODBYE)
  947.     M - SEND MESSAGE
  948.     R - RECEIVE A FILE FROM YOUR LOCATION
  949.     T - TRANSMIT A FILE TO YOUR LOCATION
  950.     ? - PRINT THE SUMMARY OF COMMANDS
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.                                      -12-
  989.  
  990.  
  991.  
  992.                                    HOST-III
  993.  
  994.  
  995. V. System Operator Commands
  996.  
  997. This  section  describes  the  options available to the person at the computer
  998. which  is  running  HOST-III.  This person (which is you) is called the system
  999. operator.
  1000.  
  1001.  
  1002. HOST-III recognizes 4 commands from the system operator. They are:
  1003.  
  1004.     CTRL Prtsc - Printout on / Printout off (of intercomputer correspondence).
  1005.     ALT D      - Display files / View a file. (Inactive during a comm. link).
  1006.     ALT M      - Send message to remote location.
  1007.     ALT X      - Exit program.
  1008.  
  1009. They  are activated by a double key depression. That is, the first key must be
  1010. pressed while the second key is hit, then both keys are released.
  1011.  
  1012.  
  1013. A description of how HOST-III responds to each command follows.
  1014.  
  1015.  
  1016.                                    CTRL Prtsc
  1017.  
  1018. This  command  allows you to turn on the printout if it is off, or to turn off
  1019. the  printout  if  it is on. With the printout on, all commands, responses and
  1020. messages  transferred  during  an active communications link are listed on the
  1021. printer  as well as the display. NOTE that printout is deactivated during file
  1022. transfer.  If  the  printout is off when this command is issued, then HOST-III
  1023. turns the printout on, beeps and responds with
  1024.  
  1025.     --- PRINTOUT ON ---
  1026.  
  1027. If  the  printout  is  on when this command is issued, then HOST-III turns the
  1028. printout off, beeps and responds with
  1029.  
  1030.     --- PRINTOUT OFF ---
  1031.  
  1032. At startup the printout is initially off.
  1033.  
  1034.  
  1035.                                     ALT D
  1036.  
  1037. This  command allows you to both display the file directories on disk drives A
  1038. B,  C  and  D  and  view  an  ASCII  file. Viewing a file means displaying the
  1039. contents  of  an  ASCII  file  on the screen. Upon receiving this command, the
  1040. program responds with
  1041.  
  1042.     Drive A, B, C, D, View a file or Return? (A,B,C,D,V,R):
  1043.  
  1044. If  you  enter an A, B, C or D, the program will display the file directory of
  1045. the corresponding disk drive.
  1046.  
  1047. If you enter a V, the program will respond with
  1048.  
  1049.     Name of file:
  1050.  
  1051.  
  1052.  
  1053.  
  1054.                                      -13-
  1055.  
  1056.  
  1057.  
  1058.                                    HOST-III
  1059.  
  1060.  
  1061. At this point you may enter the filename specification of the file you wish to
  1062. see.  HOST-III  will  display 18 lines of the file at a time and prompt you to
  1063. continue  by  pressing  the  space bar. You may abort the viewing of a file by
  1064. hitting the ESC key.
  1065.  
  1066. To  return  to the program's normal mode, you must enter an R when the program
  1067. asks  you to select an option.
  1068.  
  1069. NOTE  the program will ignore the ALT D command, if it is engaged in an active
  1070. communications link.
  1071.  
  1072.  
  1073.                                     ALT M
  1074.  
  1075. This  command  allows  you to send the user a one line message. Upon receiving
  1076. this command the program responds with
  1077.  
  1078.     *** SYSTEM OPERATOR MESSAGE ***
  1079.  
  1080. At  this  message you may enter a message followed by a carriage return, which
  1081. HOST-III will send to the user. NOTE the user will not receive the prompt
  1082.  
  1083.     >
  1084.  
  1085. after  a  system  operator message, because the program is still waiting for a
  1086. response  to  the prompt it issued just before the message. Therefore the user
  1087. can issue his/her next command immediately after receiving the message.
  1088.  
  1089.  
  1090.                                     ALT X
  1091.  
  1092. This command allows you to exit the program. HOST-III responds to this command
  1093. with
  1094.  
  1095.     --- EXIT ---
  1096.  
  1097. and terminates the program.
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.                                      -14-
  1121.  
  1122.  
  1123.  
  1124.                                    HOST-III
  1125.  
  1126.  
  1127. VI. File Transmission
  1128.  
  1129. This  section  describes the protocol involved in transferring a file from the
  1130. HOST-III location to the user's location.
  1131.  
  1132.  
  1133. Upon receiving the command
  1134.  
  1135.     T
  1136.  
  1137. from the user, the program responds with
  1138.  
  1139.     NAME OF FILE:
  1140.  
  1141. HOST-III  is  asking  the  user  to give it the full name of the file the user
  1142. wants to be transmitted. For instance if the user wants the file PROG2.BAS and
  1143. it resides on drive B, then the user may respond with
  1144.  
  1145.     B:PROG2.BAS
  1146.  
  1147. followed  by  a carriage return. If HOST-III encounters an error such as "file
  1148. not  found" or "disk not ready", then the program will inform the user of this
  1149. and send him/her a prompt for the next command.
  1150.  
  1151. If there are no errors then HOST-III tells the user
  1152.  
  1153.     *** TRANSMISSION BEGINNING IN 15 SECONDS ***
  1154.         TYPE X TO ABORT TRANSMISSION
  1155.  
  1156. The  user  now  has 15 seconds to prepare his program to receive the file. The
  1157. user may abort transmission at any time by typing an X.
  1158.  
  1159. To denote the end of the file, HOST-III sends
  1160.  
  1161.     65529 ' *** TRANSMISSION COMPLETE ***
  1162.  
  1163. The  user may remove this trailing message with a text editor before using the
  1164. file.  A  prompt  is  NOT sent after file transmission. Therefore the user may
  1165. issue  his/her  next  command  immediately after the transmission is complete.
  1166. NOTE  that if the user is the program HOSTCALL, then a trailing message is not
  1167. attached  to  the  end  of  the file since the two programs have a protocol to
  1168. determine the end of a file.
  1169.  
  1170.  
  1171.  
  1172. If  the user's program supports the XMODEM protocol of file transmission, then
  1173. he/she  may  elect to have HOST-III send him/her the file under this protocol.
  1174. To  have  HOST-III  send  the  program  PROG.COM  from drive A, the user would
  1175. respond to the request
  1176.  
  1177.     NAME OF FILE:
  1178.  
  1179. with
  1180.  
  1181.     A:PROG.COM+X
  1182.  
  1183.  
  1184.  
  1185.  
  1186.                                      -15-
  1187.  
  1188.  
  1189.  
  1190.                                    HOST-III
  1191.  
  1192.  
  1193. As  shown,  the  user  invokes  the  XMODEM  protocol by appending a +X to the
  1194. filename  specification. During transmission HOST-III will display a number of
  1195. status  messages on the screen. At the end of the file, the program will issue
  1196. its prompt and wait for the next command.
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.                                      -16-
  1253.  
  1254.  
  1255.  
  1256.                                    HOST-III
  1257.  
  1258.  
  1259. VII. File Reception
  1260.  
  1261. This  section  describes  the  protocol involved in transferring a file to the
  1262. HOST-III location from the user's location.
  1263.  
  1264.  
  1265. Upon receiving the command
  1266.  
  1267.     R
  1268.  
  1269. from the user, the program responds with
  1270.  
  1271.     NAME OF FILE:
  1272.  
  1273. HOST-III  is  asking  the  user  to give it the full name of the file the user
  1274. intends  to  send. For instance if the user intends to send the file PROG1.BAS
  1275. and he/she wants to store it on drive B, the user may respond with
  1276.  
  1277.     B:PROG1.BAS
  1278.  
  1279. followed  by  a  carriage return. If HOST-III encounters an error such as "bad
  1280. file name" or "disk write protected", then the program will inform the user of
  1281. this and send him/her a prompt for the next command.
  1282.  
  1283. If there are no errors then HOST-III tells the user
  1284.  
  1285.     *** READY TO RECEIVE FILE ***
  1286.  
  1287. The  program  will  wait  15  seconds  for  the  beginning of transmission. If
  1288. transmission has not begun within this time, the program transmits
  1289.  
  1290.     RECEPTION SUSPENDED. END OF FILE? (Y,N)
  1291.  
  1292. If  this happens, the user should just complete his procedure for transmitting
  1293. a  file.  NOTE  however  that  if  the  END  OF  FILE question is asked before
  1294. transmission  begins,  then  HOST-III  assumes  that  the  first  character it
  1295. receives  is the answer to its question. Therefore that first character is not
  1296. stored  as  part  of the received file. Moreover if the first character of the
  1297. transmitted  file  is  Y (or y), then reception is terminated. In short, it is
  1298. best for the user to initiate his transmission within 15 seconds.
  1299.  
  1300. At  the  end  of  transmission,  the  program  pauses for about 15 seconds and
  1301. transmits
  1302.  
  1303.     RECEPTION SUSPENDED. END OF FILE? (Y,N)
  1304.  
  1305. If the user responds with Y (or y) or if there is no response within 1 minute,
  1306. HOST-III terminates reception and tells the user
  1307.  
  1308.     *** RECEPTION TERMINATED ***
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.                                      -17-
  1319.  
  1320.  
  1321.  
  1322.                                    HOST-III
  1323.  
  1324.  
  1325. If  the user's program supports the XMODEM protocol of file transmission, then
  1326. he/she  may  elect  to  have HOST-III receive the file under this protocol. To
  1327. have  HOST-III  receive the program PROG.COM and store it on drive A, the user
  1328. would respond to the request
  1329.  
  1330.     NAME OF FILE:
  1331.  
  1332. with
  1333.  
  1334.     A:PROG.COM+X
  1335.  
  1336. As  shown,  the  user  invokes  the  XMODEM  protocol by appending a +X to the
  1337. filename  specification.  During  reception  HOST-III will display a number of
  1338. status  messages on the screen. At the end of the file, the program will issue
  1339. its prompt and wait for the next command.
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.                                      -18-
  1385.  
  1386.  
  1387.  
  1388.                                    HOST-III
  1389.  
  1390.  
  1391. VIII. HOST-III Signoff
  1392.  
  1393. This section lists the conditions which will cause HOST-III to sign off.
  1394.  
  1395.  
  1396. When  HOST-III  is  dialed  and  it  initiates communications by answering the
  1397. telephone,  there  are 6 ways in which these communications can be terminated.
  1398. They are:
  1399.  
  1400.     1. Normal signoff command - G.
  1401.     2. Timeout after 5 minutes of inactivity.
  1402.     3. Incorrect password in 3 tries.
  1403.     4. Failing  to  detect  a  carrier  (such as when it is  called by a human
  1404.        instead of a computer).
  1405.     5. User hangup before correct password is issued.
  1406.     6. User hangup during active communications.
  1407.  
  1408. In all cases HOST-III will clear the screen, issue the message
  1409.  
  1410.     ********* HOST COMPUTER III program active *********
  1411.  
  1412. and wait for the next telephone call.
  1413. 
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.                                      -19-
  1451.  
  1452.  
  1453.  
  1454.